home *** CD-ROM | disk | FTP | other *** search
/ Gold Medal Software 3 / Gold Medal Software - Volume 3 (Gold Medal) (1994).iso / bbsutils / sara21.arj / SYSOP.DOC < prev    next >
Encoding:
Text File  |  1994-02-17  |  13.5 KB  |  275 lines
  1.  
  2.  
  3.  
  4.              UltraSoft SARATOGA RACEWAY Version 2.1 Documentation
  5.                          Written by Steve Hansen
  6.  
  7.              Copyright(C) UltraSoft 1992,1993,1994
  8.                           Software Division of
  9.                           UltraSystems Hawaii
  10.  
  11.                           5070 Likini St.
  12.                           Suite 1209
  13.                           Honolulu, HI 96818
  14.  
  15.                           UltraSoft BBS Support System
  16.                           (808)833-1525
  17.  
  18.                           ACME BBS - Livermore, CA
  19.                           UltraSoft Product Support BBS - West
  20.                          
  21.                           Acme has either changed location and
  22.                           numbers or has shut down. Awaiting
  23.                           notification and new numbers.
  24.  
  25.                           Dan's Place BBS - Wahiawa, HI,  also
  26.                           features UltraSoft Doors and Products
  27.                           (808)624-9239
  28.                    
  29.                           UltraSoft CompuServe ID: 75120,2506
  30.                           UltraSoft GEnie ID: A.Hansen2
  31.  
  32.  
  33. Introduction
  34. ----------------
  35. Welcome to Saratoga Raceway, one of the series of Animated Graphics Door
  36. Games for BBS Systems, produced by UltraSoft. This Door Game operates in
  37. ANSI graphics mode only. Non-ANSI callers are given a choice of changing
  38. their graphics mode (if possible) or otherwise are restricted from playing.
  39. This is due to the extensive animation and ANSI position controls involved,
  40. which would not be at all feasible in a Text Mode situation. We find that
  41. the volume of Text Mode (non-graphics) callers is diminishing rapidly as
  42. computers become more and more enhanced and less expensive anyway.
  43.  
  44. If you are a Registered User of Saratoga Raceway and this is a new release,
  45. you need only decompress this archive into a subdirectory and copy in key 
  46. files from your previous operating Game. These Key Files include: PLAYER.$$$, 
  47. SARATOGA.SYS, THE BLT'S AND BLTG'S, and the .LMO files to retain existing 
  48. scores and rankings. If you are not a registered User, you will receive a 
  49. file called SARATOGA.SYS which will open up the full registered game for you.
  50. With regisration, you will also receive some valuable utilities for use with 
  51. this and other games. Please refer to the documentation contained in those 
  52. packages, for instructions on their use.
  53.  
  54. Saratoga Raceway is a Horse Racing game which has proved itself to be among
  55. the most popular games ever, featured at our Hawaii support BBS. In addition
  56. to full animation, S/R introduces extensive online sound effects. It not only
  57. features betting on horses to Win, Place or Show, and winning the Big Bucks,
  58. one must go to the Raceway (which is not in the best part of town), prepared
  59. for possible approaches by the Tax Man, a variety of Pick-Pockets and hoods,
  60. who frequent the track, preying on any opportunity for the fast buck from an
  61. unsuspecting winner, and other sinister characters, some of which have your
  62. best interests at heart, and some who may not. There are also several other
  63. opportunities to gain riches there, other than simply winning at the horses,
  64. if one can survive that long.
  65.  
  66. Getting Started
  67. -----------------
  68. The best way to truly appreciate the game is to install it and run it yourself.
  69. This can be done quite easily, as you will see from the following comments.
  70. However, if you'd like to get a Saratoga Raceway Demonstration run right now,
  71. Just make sure all files in the distribution package are accessable to the
  72. program in a single subdirectory, and type:  SARATOGA /L  to run it in Local
  73. Mode. The [/L] command line parameter detaches the program from any BBS..
  74.  
  75. Disclaimer
  76. -----------
  77. Saratoga Raceway has been extensively tested, and should provide no
  78. possibility of harm to your system in any way. However, no warrantees, either
  79. expressed or implied are provided with this software and one must run it
  80. purely at his/her own risk, without liability to UltraSoft or to the author.
  81.  
  82. Compatibility overview
  83. ------------------------
  84. Saratoga Raceway is currently capable of being operated on any BBS System
  85. that uses a DOOR.SYS or a DORINFOX.DEF door interface file. This includes:
  86. GAP/PCBoard/RoboBoard/WildCat/RBBS/QuickBBS/Random Access and many others,
  87. not to exclude other BBS Software that will run doors for the above. In some
  88. cases, a conversion utility such as QKDoor.EXE or DoorFrame might be
  89. needed to convert, preferably to DOOR.SYS, (since this is a highly animated
  90. Game, and requires awareness of the Caller's connect speed) or DORINFOX.DEF,
  91. which does not pass connect speed to the Door, but is accomodated inside the
  92. Saratoga Raceway Door.
  93.  
  94. Saratoga Raceway may also be run at any Baud Rate up to 115,200bps and is
  95. compatible with COM1 through COM4 with release 2.0+. Previous releases were
  96. compatible with only COM1 and COM2 due to these limitations of the Compiler.
  97. Saratoga Raceway is Multi-Node aware, and has been tested successfully with
  98. and without DesqView. Standard IRQ's are 4 for COM1 and COM3 and 3 for COM2
  99. and COM4. Use with non-standard IRQ arrangements is unpredictable and has
  100. not been tested to date. Feedback for non-standard IRQ's, or any other unique
  101. system configuration is welcomed.
  102.  
  103. Running with DesqView
  104. ------------------------
  105. Saratoga Raceway has been tested with QuarterDeck's DesqView Multi-Tasker.
  106. The only consideration necessary for this mode of operation is to activate the
  107. ANSI driver from QuarterDeck, prior to calling the game. In this case, place
  108. the line  C:\DV\DVANSI.COM  as the first line in your batch file which calls
  109. the game. (i.e. SARATOGA.BAT)  MSDOS's ANSI.SYS is ignored by DesqView and is
  110. replaced when necessary by DVANSI.COM, a TSR. Saratoga Raceway requires ANSI
  111. support to run properly.
  112.  
  113. Running with Windows
  114. ------------------------
  115. Saratoga Raceway has not been tested running on a BBS System under MicroSoft
  116. Windows or IBM OS/2.. Feedback is welcomed.
  117.  
  118. Note:
  119. -----------
  120. Saratoga Raceway is maintenance free, in that no Maintenance program exists..
  121.  
  122. As a safety measure against corrupted files, the program backs up it's Player
  123. File each time a caller enters the Door. As such, if for any reason you lose
  124. an active player file,  a backup will exist in the operating directory, with
  125. the last two letters of the extention being BU.. (PLAYER.$BU) But, it will be
  126. overwritten with the active file as soon as another player enters the game.
  127. We recommend also backing up these files during a nightly BBS Event process.
  128.  
  129. If there are any unforseen complications with the use of this door game, in
  130. any configuration, we would appreciate hearing about it. please notify the
  131. author(s) at one of the locations shown at the beginning of this document.
  132.  
  133. Installation
  134. ---------------
  135. We have attempted to keep simplicity at the forefront in designing UltraSoft
  136. Games. We hope installation is among the simplest you have ever encountered.
  137.  
  138. STEP 1: Create a directory where the Door Game will reside.
  139. i.e.   C:\BBS\DOORS\SARATOGA
  140.  
  141. STEP 2: Expand all of the files in the distribution package into the new
  142. Directory.
  143.  
  144. STEP 3: Create a BAT file to call the Game from your BBS System. This
  145. normally will reside in your BBS default directory.
  146. i.e.   C:\BBS\SARATOGA.BAT
  147.  
  148. STEP 4: Edit the existing SARATOGA.CFG file to indicate your operational
  149. preferences as shown below.
  150.  
  151. STEP 5: Enjoy the game and feel free to offer suggestions for future
  152. enhancement releases.
  153.  
  154. ---------------------------------------------------------------------------
  155.  
  156. The SARATOGA.BAT file should contain lines very similar to the following.
  157.  
  158. ==SARATOGA.BAT=============================================================
  159. @ECHO OFF         <-- If you do not with to see the BAT activity in progress
  160. CD BBS\DOORS\SARATOGA <-- Or wherever this Door Game resides
  161. SARATOGA          <-- Run it (can be assigned another CFG file as a parameter)
  162. CD\BBS            <-- When done return to BBS Default Directory
  163. BBS               <-- Re-Call the BBS System, if necessary
  164. ===========================================================================
  165.  
  166. Many variations to this may be included, for example:
  167. ------------------------------------------------------------------------
  168. If you are installing the Registered version of Saratoga Raceway, you
  169. received a Name Conversion utility to change the name SYSOP to your own
  170. name, as you enter the Door, to allow you to enter and play the game as
  171. you, rather than as SYSOP, without having to sign back in to the BBS to
  172. play as yourself.. This utility is called DSA.EXE, (If running DOOR.SYS)
  173. and DIA.EXE (If running DORINFOX.DEF). If using one of these utilities,
  174. simply include it as the first line in your BAT file.
  175.  
  176. If you are installing the Registered version of Saratoga Raceway, you may
  177. have also received an activity tracking utility, which creates User Graphs
  178. for Sysop analysis and/or for Bulletin purposes. This should also be installed
  179. prior to the first line of the BAT file, as shown above. Please see additional
  180. DOC files within each of these packages..
  181.  
  182. Saratoga Raceway creates User Bulletins as well, called:
  183.  
  184. BLTG.   -for the ANSI graphics Bulletin
  185. BLT.    -for the ASCII Bulletin
  186.  
  187. Normally these would be copied to wherever you like, after execution of the
  188. game. For example:
  189.  
  190. ==SARATOGA.BAT==============================================================
  191. CD\BBS\DOORS\SARATOGA
  192. SARATOGA
  193. copy bltg. C:\BBS\GEN\BLT15G.   <--copy bltg. to your chosen ANSI Bulletin
  194. copy blt. C:\BBS\GEN\BLT15.     <--copy blt.  to your chosen ASCII Bulletin
  195. CD\BBS
  196. BBS
  197. ============================================================================
  198.  
  199. In this case, these lines should be inserted in the BAT file just after the
  200. line SARATOGA, as shown above.
  201. ------------------------------------------------------------------------
  202.  
  203. A configuration file is used in Saratoga Raceway, to be called SARATOGA.CFG.
  204. Additional configuration files may be used instead, if called as a parameter
  205. from the SARATOGA command line in your SARATOGA.BAT file.
  206.  
  207. i.e. SARATOGA OTHER.CFG  <--Name of your other .CFG file..
  208.  
  209.  
  210. A Sample SARATOGA.CFG is included with your package for reference.
  211.  
  212. The format of this file is internally notated and appears as follows:
  213.  
  214. ==SARATOGA.CFG====================================
  215. C:\BBS\DOOR.SYS
  216. 3
  217. 20
  218. 30
  219. 1
  220. ============================================================================
  221. Line 1 = Full Path\Filename to User Interface File (DOOR.SYS or DORINFOX.DEF)
  222. Line 2 = Number of Sessions allowed a caller in any one day
  223. Line 3 = Number of Races allowed a caller in any one day (Unregistered = 5)
  224. Line 4 = Minutes allowed in each session
  225. Line 5 = Nodes in operation. (1 if Single Node, More than 1 of Multi-Node)
  226. ============================================================================
  227.  
  228. Saratoga Raceway can be run LOCALLY in one of two ways. Either use the /L
  229. command line parameter mentioned above, or if installed on a BBS System,
  230. make sure the appropriate Door Interface File (DOOR.SYS or DORINFO1.DEF) in
  231. the location shown in line 1 of the SARATOGA.CFG, file is created or edited
  232. to indicate COM0 as the caller's comm port. Saratoga also responds to any
  233. alternate .CFG file you choose, by including the name of the .CFG file on
  234. the command line as a parameter.  i.e.  SARATOGA OTHER.CFG  .. Obviously,
  235. that .CFG file must exist, and if it is in some other directory, it must be
  236. included in the parameter..  i.e.  SARATOGA C:\BBS\OTHERDIR\OTHER.CFG ..
  237.  
  238. REGISTRATION
  239. ---------------
  240. For continued development of the wide variety of UltraSoft products,
  241. including this one, please register withing a period of 30 days after
  242. installation and testing. This will entitle you to all future version
  243. updates as a Registered Licensee. You then must only retain your
  244. SARATOGA.SYS file and either order the product directly from UltraSoft at
  245. minimal cost of $6.00 for Media, Shipping and Handling or simply download
  246. the newer shareware version from your favorite BBS, copying in your
  247. Registered SARATOGA.SYS file into the SARATOGA subdirectory. This file
  248. CANNOT be edited/altered in any way, without adverse effect to the game.
  249.  
  250. The Unregistered version of Saratoga Raceway has some restrictions. We
  251. regret that this is necessary, but for further development of this and many
  252. other UltraSoft products, Registration revenues must be realized. Earlier
  253. versions of our variety of products which were unrestricted, simply proved
  254. that unrestricted products are seldom registered by the public, where
  255. restricted products are. We wish this were not the case, but this product
  256. in particular has undergone many enhancements in Beta Test, and the time
  257. involved in complete creation and enhancement actually amounts to some years
  258. of major effort, beta testing and more re-writes.
  259.  
  260. In the unRegistered version, there are a maximum number of 5 races that can
  261. be run by any caller in one day. Registration makes this unlimited and
  262. completely under control of the Licensed Sysop. It also credits the Sysop
  263. with his/her name at the top of the Primary Game Screen and on initial caller
  264. entry into the game.
  265.  
  266. Please see WHATS.NEW for a listing of revisions included in this release. There
  267. is also another acchive enclosed, which contains ANSI and ASCII artwork that
  268. can be used as News Files or Bulletins to make you callers more aware of the
  269. existance of Saratoga Raceway among your Door Games.
  270.  
  271.      If you haven't already done so,              Aloha!
  272.      Please Register, and Enjoy!                  Steve Hansen
  273.                                                   UltraSoft - Hawaii
  274.  
  275.